home *** CD-ROM | disk | FTP | other *** search
/ Pascal Super Library / Pascal Super Library (CW International)(1997).bin / LIBRARY / PBLIB1 / UTILS01.TXT < prev   
Text File  |  1994-05-02  |  7KB  |  126 lines
  1.             FREE Utility Programs with source
  2.                    Howard Richoux   CServe 76350,1772
  3.                       May 2, 1994
  4.  
  5.      The concept I am trying to push is the cooperative creation
  6. and maintenance of a comprehensive TP7 DOS code library.  Maybe the
  7. way to convince people of the need is to demonstrate its usefulness.
  8. I am packaging up a group of utility programs I have written.  These are
  9. now PUBLIC DOMAIN (even though many still list a copyright to HNR Software).
  10.  
  11.      Caveat - Many of these "just grew" and are still growing.  I use
  12. them until they don't do what I want then I improve them, or start over.
  13. Source for everything is bundled into the CServe PUBLIB.ZIP in the GENERAL
  14. section.  If you want to experiment with public domain library concepts, or
  15. play with modifying these utilities, down-load and have fun.  Hopefully, in
  16. the next few weeks, a true PUBLIB V1.00 can be constructed with reasonably
  17. permanent structure and naming.  This should be the real starting point
  18. for coding.
  19.  
  20.      In the mean time, these EXE files and accompanying (sparse) documentation
  21. will serve as a useful concept prover.
  22.  
  23.      One last caveat - I didn't say these were small - just useful.  For
  24. example, the DDIR.EXE program is 24k replacing a DDIR.com I had been using
  25. which was under 1k.  But somebody else owned that one, there are real or
  26. imagined restrictions on my re-distributing of it, and if it didn't exactly
  27. fit my desires, I couldn't change it.  Disk space is getting very cheap these
  28. days, and 24k loads and runs as quickly as 1k.
  29.  
  30.      In the current library version, special printer options produce HPCL
  31. escape sequences, rather than any dot matrix sequences.  This should be
  32. generalized when we move to PUBLIB V1.00    This applies to COMPRESSED
  33. and LANDSCAPE options.
  34.  
  35. 1. DDIR - the old DoubleDirectory. Sorts file names alphabetically, lists
  36.        two to a row.  When OUT=LPT1, printing uses whole column length.
  37.          DDIR(cr)        shows current directory
  38.          DDIR <dirspec>  shows <dirspec> directory
  39.  
  40.        Special cases - DDIR p(cr)  (or P, or   DDIR <dirspec> p(cr)  )
  41.             causes output to go to LPT1:(equiv OUT=LPT1)
  42.  
  43.        If config parameter COMPRESSED=YES then DDIR produces 3 columns
  44.             per line.
  45.  
  46. 2. DIRS - produces a dump of first level subdirectories sorted
  47.         alphabetically, with number of files found, total size and latest
  48.         file date.  These numbers include lower level subdirectories.  This
  49.         is useful in deciding what to kick off the disk to make room.
  50.         Useful  DIRS p(cr) to go to printer.
  51.  
  52. 3. FIND - the old findfile idea, like FIND *.pas or FIND ab?de.*
  53.         Note the batch file BIGFILES.BAT.  This uses a couple of
  54.         parameters to change the operation into a search for files
  55.         greater than a threshhold.
  56.  
  57. 4. README - A simple text file viewer.  Lets you pick files to look
  58.         at and you can page through them.  Ctrl-PrintScreen lets you
  59.         print the whole file.
  60.  
  61. 5. DUMP - HEX file dump utility.  Options to designate a file header
  62.         size and record size to help decode mystery files.  Options
  63.         to view only some records.  See dump.doc
  64.  
  65. 6. COMPILE - TPCs a list of files (compile.cmd), checking to see if
  66.         tpu or exe is produced.  After all done, goes back and compiles
  67.         the first one that failed so that you can see the error.  I use
  68.         this a lot when I make global changes to the libraries to catch
  69.         missed references.
  70.  
  71. 7. TLISTER - My primary textfile --> printer program.  As configured,
  72.         (tlister.cfg below).
  73.  
  74. {TLISTER.CFG - configuration settings, place with TLISTER.EXE}
  75. {  if param not present, defaults are used                   }
  76. OFFSET=6       {left pad blanks                 def. 6    }
  77. OUT=LPT1       {set output to LPT1:             def. CON  }
  78. COMPRESSED=YES {set 132 col 8 lpi               def. NO   }
  79. {can be overridden on param line}
  80.  
  81.         this takes a text file and sends it to LPT1  compressed mode(HPCL)
  82.         with a left margin of 6 chars added and a simple header.  It can
  83.         handle an input spec of *.xxx to list a bunch of files. Input file
  84.         extension defaults to .pas.  See TLISTER.doc for a little more.
  85.  
  86. 8. TPRINT - flexible text file to printer program - do  >TPRINT TPRINT.doc
  87.  
  88. 9. USES  either USES <*>  or USES <unitname>  - scans *.pas for unit source
  89.          and lists out USES statement.  Good for checking who uses what.
  90.  
  91. 10.TMAP  not too great program to analyse Pascal .MAP files.
  92.  
  93. 11.READSECT - nearly trivial exercise of HELPSTUF library code. Just
  94.          type readsect and you get windowed random access viewing of
  95.          the test.txt file.  This is primarily to show what can be done
  96.          rather than be useful in itself.
  97.  
  98. 12 SORTSECT - comparable to READSECT, sorts a text file which has been
  99.          divided into sections.
  100.  
  101.  
  102. 13&14 ZIP and PUT - Together, these are my backup utilities.  I find the
  103.          structure very pleasing - others may completely object.  Step 1
  104.          get and register PKZIP.  This has been an extremely useful
  105.          utility for years and only gets better.  I have a directory on
  106.          C: named \ZIP where I keep archives until I move them to floppy.
  107.          The ZIP program simply invokes PKZIP to copy and compress the
  108.          current directory to \ZIP with the directory name as the ZIP name.
  109.          I configure ZIP to erase *.bak and *.tmp first to clean things up some.
  110.          This only takes a few seconds, so I can do it frequently, replacing
  111.          the prior backup.  I do this maybe 5 or 10 times an hour during
  112.          development, and immediatly after successful changes to the libraries.
  113.               PUT is configured to copy from \ZIP to the B: floppy, but
  114.          only actually copying files which have changed on \ZIP.  ZIP and PUT
  115.          are tuned to my individual taste, but between the CFG file options
  116.          and changing a little code, I'm sure most people can be satisfied.
  117.          I am much more relaxed when I have lots of backup copies on floppy.
  118.  
  119.  
  120. This is enough for now.  The XBASE utility deserves more specific
  121. documentation.  If you are in desparate need of XBASE stuff, drop me a msg.
  122.  
  123. I have code generators for dbf and dbt objects and binary file objects -
  124. associated with objects in publib.
  125.  
  126. I really need to know what people need and have to share.